home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
programs
/
faxem20.zip
/
FAXEM.DOC
< prev
next >
Wrap
Text File
|
1993-03-01
|
12KB
|
285 lines
═══════════════════════════════════════════════════════════════════════════
Faxem Release 2.0
Fax ASCII Text file while Online!
Door Registration is only $25.00!
Written by: Jerry Liddle
119 Edward Drive
Swedesboro, New Jersey 08085
The Beckett BBS (609) 467-3898 USR 14.4 Dual Standard
(609) 467-8612 USR 16.8 Dual Standard
(609) 467-0515 14.4 Boca V.32bis
═══════════════════════════════════════════════════════════════════════════
Warranty
This product is provided "as is" without warranty of any kind. The entire
risk as to the results and performance of the program is assumed by you.
Futhermore, the author does not warrant, guarantee, or make any other
representations regarding the use of, or the results of the use of the
program, and you rely on the program and results solely at your own
risk. The author cannot and will not accept responsibility for system
damage, loss of profit, or any other special, consequential or incidental
damages resulting from the use or inability to use this product.
FAXEM will run on systems that are compatible with PCBOARD.SYS,
USERS.SYS, DOOR.SYS, CALLINFO.BBS, USERINFO.DAT, SFDOORS.DAT,
GTUSER.DAT, TRIBBS.SYS, CHAIN.TXT or DORINFOx.DEF for interfacing
to the BBS.
Overview of Faxem
──────────────────────────────────────────────────────────────────────────
Ok, Folks. This is my first attempt at writting a door. So be patient
with me. Needless to say, I'm not good at writing docs either. If you
need help setting-up Faxem, TOUGH... Just kidding... I can be reached
through my BBS. I also monitor many RIME conferences. Especially the
Doors and GAP Conferences.
Faxem was written to provide users of my BBS the ability to Fax ASCII
Text files to other fax machines in the area.
I have the door set up to allow FREE local faxing. It's a great service
that is fairly cheap to add to your system. You can make your own arrange-
ments with users to have them pay per fax for toll calls. The door keeps
track of the number of pages sent. I charge per page for Long Distance.
All in all, I think you'll be quite pleased.
************************ N E W F E A T U R E S **************************
For those who have fax modems that cannot run BitFax Software, I have added
a feature that will allow your users to upload their fax document into the
door and save the file. The user can leave a comment to the sysop informing
him/her that there is a fax request pending. Also, if the sysop logs into
door local or remote, he/she will be told that a fax request is pending.
The sysop sends the file during a maintenance event, or uses the fax
software to schedule fax send. Use your imagination.
Fossil Driver Support
---------------------
Faxem supports the use of Fossil drivers. To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
FAXEM FAXEM.CFG /FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, FAXEM will print a message to that effect and exit
the door gracefully.
Environment Variables
---------------------
FAXEM supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
number after the configuration filename. EXAMPLE:
FAXEM FAXEM.CFG /5 or
FAXEM FAXEM.CFG /%IRQ% for the environment variable.
The /5 tells FAXEM to use IRQ5 rather than the standard IRQ4 that
is normally used with COM1. No /x parameter is needed for the standard IRQ's.
When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:
PCBoard:
USERS.SYS in C:\PCB - %pcbdrive%%pcbdir%\USERS.SYS
USERS.SYS in C:\PCB\NODE1 - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
Wildcat!:
USERINFO.DAT in C:\WC\NODE1 - C:\WC\NODE%wcnodeid%
Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch file that runs the door. For example:
SET PCBDRIVE=C:
SET PCBDIR=\BBSDIR
SET PCBNODE=1
**************************************************************************
Fax-Door Requirements
──────────────────────────────────────────────────────────────────────────
- You'll need room in your computer for an internal Fax-Modem. That not only
means phsyical space, but also free interupts and com ports. An external
modem may also be used. (I use an external modem)
- You need an extra phone line, in ADDITION to the BBS Line, as the door
faxes with the caller online. I cheated a little here, I use my voice
line. Odds are that the line will be free most of the time.
- You need a Fax modem that uses the BitFax software (C) 1989 BIT Software,
Inc. All Rights Reserved. I have used BitFax v3.0 successfully.
Else, try the new feature added mentioned above.
See sample config file for setting up this feature...
- All files for the door should be placed in the BitFax directory.
By this I mean, run the door from the BitFax Directory...
The door files may reside anywhere if you are not using BitFax.
- This only works on the node where the Fax-Modem is inserted. On a multi
node system, this means the fax service will only be available on one of
your nodes, unless you have more than one Fax-Modem.
True multinode if using the OTHER feature (new feature) mentioned above.
Naturally, if you are not using BitFax, the door is truely multinode.
- You must have a copy of DSZ in your Path or in the Door Directory
- The door shells out to run BitFax and DSZ to accept the uploaded file to fax.
Boards operating under DoubleDos or Desqview must be sure they have enough
RAM leftover for proper door operation.
- You will NOT need a copy of BRUN45.EXE for the door to operate.
- This door was written for system that use ANSI.SYS in their config.sys files.
Files needed for Fax-Door Operation
──────────────────────────────────────────────────────────────────────────
If you have any doubt about the integrity of the files contained in this
Archive, feel free to call my BBS in Swedesboro, New Jersey and download
the latest version. The Beckett BBS, (609)467-3898/8612/0515
Files included with Faxem and created by the door: Files marked with an
asterisk "*" are created by the door. Be sure to check the transfer batch
files so they are set for the correct com port that the door will be using.
NOTE: Do not change the names of the file transfer Protocol Batch Files
They may be edited to add options
FAXEM.DOC <----- The How To File - The Documentation
FAXEM.EXE <----- This is the door executable file
FAXEM.CFG <----- The door configuration file (Instructions in Sample)
FAXEMWLC.ASC <----- The door ascii welcome screen (Do Not Alter)
FAXEMWLC.ANS <----- The door Ansi welcome screen (Do Not Alter)
FAXLOCAL.TXT <----- ASCII file containing local calling prefixes (Edit)
One prefix per line (For area code where BBS lives)
FAXZONE1.TXT <----- ASCII file containing local calling prefixes (edit)
for additional local area code on line 6 of faxem.cfg
One prefix per line (create file if needed)
FAXZONE2.TXT <----- ASCII file containing local calling prefixes (edit)
for additional local area code on line 7 of faxem.cfg
One prefix per line (create file if needed)
FAXZONE3.TXT <----- ASCII file containing local calling prefixes (edit)
for additional local area code on line 8 of faxem.cfg
One prefix per line (create file if needed)
*FAXUSER.DAT <----- Door user data file (Do Not Alter)
*FAX2SEND.DAT <----- Door user data file of pending faxes. Can be
deleted when all faxes listed have been sent.
The door will also ask if you wish to delete this
file after it is displayed to the sysop after he/she
enters the door.
INSTRUCT.TXT <----- Instructions displayed by door (May be Edited)
This file may be edited to inform users how
you have the door set to operatate with BitFax
DIRECT.TXT <----- Same purpose as INSTRUCT.TXT. Directions for users
when the door is operated with OTHER than BitFax
Software.
REGISTER.FRM <----- Registration Form
XM1KG.BAT <----- File transfer batch files (Do Not Rename - May Edit)
XMDIK.BAT <----- "
XMDCRC.BAT <----- "
YMD.BAT <----- "
YMD1KG.BAT <----- "
ZMD.BAT <----- "
If using BitFax software, all of the above files should be in the same
subdirectory as your BitFax software.
To call the door from with a BBS program:
Faxem Faxem.cfg [/x]
For Multi-Node operation, each node's configuration file must have
a unique name. ie. Faxem1.cfg for Node 1, Faxem2.cfg for Node 2, etc.
[x] = optional parameter for non-standard com port.
The door supports com ports 1-4, but by using the
/x parameter you can assign other than the standard
irq for com port 1-4
Example: To use Com1 with Irq3
Faxem Faxem.cfg /3
==============================================================================
EDITING THE USER RECORD
==============================================================================
The door automatically knows when the sysop is in the door. Entering the
Asterisk (*) key will bring up the user editor. This will allow you to
enable long distance faxing for users of your choice. You make the
arrangement as to who, how, and when the toll call is to be paid. I have
my users prepay for this service. I charge per page to fax. The editor
is basically self explanatory.
Editor Menu: 1. Edit A User Account
2. Delete A User Account
Q. Return To Fax-Em
G. Log-Off System
Edit A User: A. User Number <----- User's record Number
B. Pages <----- User's preapproved L/D Pages
C. Sent <----- Pages a user has sent
Protocol <----- User's default protocol
D. Long Distance <----- Y or N (enables/disables L/D
SETTING UP BITFAX
──────────────────────────────────────────────────────────────────────────
Suggest following the instructions for BitFax when installing the software.
Make a subdirectory called BITFAX on your drive.
Change to the subdirectory, and copy the contents of the BitFax/SR Program
disk into the subdirectory. Next, place the Faxem files in this directory,
as Faxem will read the Log file created by BitFax.
Be sure to set your com port correctly on the Fax-Modem. I run a USR HST
14.4 on Com2 and have my Fax-Modem set to use Com1.
Once your Fax-Modem is installed and your software is loaded onto the hard
drive you should type BITFAX and set up the BitFax parameters. Please
follow the BitFax manual. Their manual contains step by step instructions.
Registration Cost
──────────────────────────────────────────────────────────────────────────
The DOOR only costs $25.00!! It is a full working version, except
that it will only allow 10 users in the data base and say it is an
EVALUATION COPY on the welcome screen.
Support the Shareware concept...
──────────────────────────────────────────────────────────────────────────
This door may be used for an Evaluation period of 30 days. After that, I
would prefer that you register the program for continued use.
To Register, please print out and return the REGISTER.FRM in the Zip file.
When you register, you may call my BBS and obtain your registration number,
which will unlock all the features of the door. When registered, the door
will display your BBS Name on the Welcome Screen. You can also register
online with a credit card (Type ORDER at the Main Menu).
Thanks for your support!